home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / dev / misc / ahidev.readme < prev    next >
Text File  |  1998-01-05  |  15KB  |  322 lines
  1. Short:    Retargetable audio v4.16, Developer's Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     dev/misc
  5.  
  6.      This archive contains the developer documentation and
  7.      example source code for AHI, both for programmer who wish
  8.      to use AHI in their own applications and those who want
  9.      to write hardware drivers.
  10.  
  11.      Changes since last release
  12.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  13.      Bug fixes in the device code.
  14.      Updated documentation.
  15.      New translation (hrvatski).
  16.      Added driver for Maestro Pro to the distribution.
  17.      Added driver for Concierto to the distribution.
  18.  
  19.  
  20. TITLE
  21.  
  22.      AHI Audio system
  23.  
  24. VERSION
  25.  
  26.      Release 4
  27.  
  28. AUTHOR
  29.  
  30.      Martin Blom <lcs@lysator.liu.se>
  31.  
  32. DESCRIPTION
  33.  
  34.      Retargetable Audio for AmigaOS
  35.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  36.  
  37.      (When refering to this software, the correct term is
  38.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  39.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  40.  
  41.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  42.      However, many features are lacking:
  43.  
  44.      · Very limited volime control when using 16 bit samples
  45.      · No HiFi mixing routines are available.
  46.      · No stereo samples
  47.      · No DSP effects are available.
  48.      · Less precision on some calculations
  49.      · Slower
  50.  
  51.      As you can see, this version is very primitive.  Get yourself an
  52.      accelerator!  I cannot guarantee that I will continue to support this
  53.      processor in the future.
  54.  
  55.      Quick overview
  56.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  57.  
  58.      * Driver based
  59.  
  60.      Each supported sound card is controlled by a library-based audio
  61.      driver. For a 'dumb' sound card, a new driver should be written in
  62.      a few hours. For a 'smart' sound card, it is possible to utilize an
  63.      on-board DSP, for example, to maximize performance and sound quality.
  64.      For sound cards with own DSP but little or no memory, it is possible
  65.      to use the main CPU to mix channels and do the post-processing
  66.      with the DSP. Available today are drivers for
  67.  
  68.      · Aura (sampler only)
  69.      · Clarity (sampler only)
  70.      · Concierto (Picasso IV sound module)
  71.      · Delfina DSP and Delfina Lite
  72.      · DraCo Motion
  73.      · Maestro Pro
  74.      · Melody MPEG
  75.      · Paula (8/14/14c bit)
  76.      · Prelude
  77.      · Toccata
  78.      · Wavetools
  79.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  80.  
  81.      * Fast, powerful mixing routines (yeah, right... haha)
  82.  
  83.      The device's mixing routines mix 8- or 16-bit signed samples, both
  84.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  85.      (with stereo panning if desired) data, using any number of channels
  86.      (as long as 'any' means less than 128...).  Tables can be used speed
  87.      the mixing up (especially when using 8-bit samples).  The samples can
  88.      have any length (including odd) and can have any number of loops.
  89.      
  90.      * Support for non-realtime mixing
  91.  
  92.      By providing a timing feature, it is possible to create high-
  93.      quality output even if the processing power is lacking, by saving
  94.      the output to disk, for example as an IFF AIFF or 8SXV file.
  95.      There are so-called HiFi mixing routines that can be used, which
  96.      use linear interpolation and gives 32 bit output.
  97.  
  98.      * Audio database
  99.  
  100.      Uses ID codes, much like Screenmode IDs, to select the many
  101.      parameters that can be set. The functions to access the audio
  102.      database are not too different from those in 'graphics.library'.
  103.      The device also features a requester to get an ID code from the
  104.      user.
  105.  
  106.      * Both high- and low-level protocol
  107.  
  108.      By acting both like a device and a library, AHI gives the programmer
  109.      a choice between full control and simplicity. The device API allows
  110.      several programs to use the audio hardware at the same time, and
  111.      the AUDIO: dos-device driver makes playing and recording sound very
  112.      simple for both the programmer and user.
  113.  
  114.      * Future Compatible
  115.  
  116.      When AmigaOS gets device-independent audio worth it's name, it should
  117.      not be too difficult to write a driver for AHI, allowing applications
  118.      using 'ahi.device' to automatically use the new OS interface. At
  119.      least I hope it wont.
  120.  
  121. SPECIAL REQUIREMENTS
  122.  
  123.      AmigaOS release 2.
  124.      MC68020 processor or better strongly recommended.
  125.  
  126. AVAILABILITY
  127.  
  128.      Aminet, for example:
  129.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  130.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  131.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  132.  
  133.      WWW:
  134.      http://www.lysator.liu.se/~lcs/ahi.html
  135.  
  136. PRICE
  137.  
  138.      Free. But if you use it in a shareware of commercial product,
  139.      I would like a registered copy for me and each of the audio driver
  140.      authors (this is merely a wish, you don't have to do it if you don't
  141.      think we deserve it). See the AHI User's Guide for more information.
  142.  
  143. DISTRIBUTABILITY
  144.  
  145.      Copyright ©1994-1997 Martin Blom.
  146.      Freely distributable in unmodified form.
  147.      See the AHI User's Guide for more information.
  148.  
  149.  
  150. ============================= Archive contents =============================
  151.  
  152. Original  Packed Ratio    Date     Time    Name
  153. -------- ------- ----- --------- --------  -------------
  154.      632     274 56.6% 08-Aug-97 17:39:30  AHI.info
  155.     5108    2347 54.0% 04-Nov-97 23:05:26 +ahidev.readme
  156.      468     236 49.5% 08-Aug-97 17:39:30 +ahidev.readme.info
  157.      364     219 39.8% 21-Mar-97 20:13:22 +Copyright
  158.      468     229 51.0% 08-Aug-97 17:39:30 +Copyright.info
  159.    65297   17904 72.5% 04-Nov-97 22:59:54 +ahi.doc
  160.    75989   19168 74.7% 04-Nov-97 22:59:56 +ahi.guide
  161.    79854   19388 75.7% 04-Nov-97 23:00:00 +ahi.html
  162.    23055    6921 69.9% 04-Nov-97 23:00:02 +ahi_sub.doc
  163.    26982    7542 72.0% 04-Nov-97 23:00:04 +ahi_sub.guide
  164.    27939    7610 72.7% 04-Nov-97 23:00:06 +ahi_sub.html
  165.    51689   15021 70.9% 04-Nov-97 23:14:14 +devguide.guide
  166.     1373     437 68.1% 17-Sep-96 11:08:26 +asmfuncs.a
  167.    22993    5881 74.4% 29-Apr-97 09:39:48 +filesave.c
  168.     2432     966 60.2% 08-Sep-96 14:26:28 +filesave.h
  169.      594     279 53.0% 08-Sep-96 14:26:42 +filesave.i
  170.     2074     415 79.9% 02-Jun-97 12:26:46 +prefsfile.a
  171.     1525     621 59.2% 03-Jul-97 16:04:22 +smakefile
  172.      920     372 59.5% 05-Jul-97 12:39:18 +macros.i
  173.      408     172 57.8% 05-Jul-97 16:49:50 +Makefile
  174.      362     107 70.4% 05-Jul-97 15:50:02 +debug.a
  175.    84028   21004 75.0% 08-Oct-97 22:46:22 +paula_audio.a
  176.     7519     706 90.6% 31-Oct-97 16:02:24 +prefsfile.a
  177.      998     415 58.4% 07-Jul-97 23:16:50 +smakefile
  178.     7029    2218 68.4% 27-May-97 21:23:40 +asmfuncs.a
  179.     3038     418 86.2% 18-May-97 15:53:12 +prefsfile.a
  180.     1452     631 56.5% 12-Aug-97 21:39:32 +smakefile
  181.    19507    5044 74.1% 13-Aug-97 06:43:12 +toccata.c
  182.     1046     417 60.1% 23-Apr-97 21:19:50 +toccata.h
  183.      649     301 53.6% 23-Apr-97 21:19:54 +toccata.i
  184.     5794    2372 59.0% 23-Dec-95 12:19:54 +dad_audio.i
  185.     1098     625 43.0% 03-Jul-97 16:36:20 +log.ascii
  186.       98      74 24.4% 08-Feb-97 19:20:50 +makeit
  187.     2130     385 81.9% 03-Jul-97 16:34:04 +prefsfile.a
  188.      487     260 46.6% 03-Jul-97 16:35:16 +smakefile
  189.      693     403 41.8% 15-Feb-97 01:29:44 +wavetools.audio.readme
  190.    26557    6912 73.9% 03-Jul-97 16:32:26 +wavetools_audio.a
  191.      987     506 48.7% 09-Apr-97 01:54:16 +AHI-Handler.DICE
  192.    30792    7674 75.0% 09-Apr-97 01:55:50 +main.c
  193.     3960    1248 68.4% 12-Mar-97 16:28:54 +main.h
  194.    60110   15947 73.4% 09-Apr-97 01:55:50 +main.c,v
  195.      199     137 31.1% 05-Jul-97 16:54:20 +smakefile
  196.      407     173 57.4% 05-Jul-97 16:55:20 +Makefile
  197.     2916    1945 33.2% 04-Nov-97 22:49:34 +PlayTest
  198.     3579    1451 59.4% 08-Apr-97 23:34:36 +PlayTest.c
  199.      138     119 13.7% 26-Mar-97 02:07:36 +SCOPTIONS
  200.      306     168 45.0% 02-Jul-97 10:29:48 +smakefile
  201.     2736    1833 33.0% 04-Nov-97 22:49:46 +RecordTest
  202.     2724    1136 58.2% 08-Apr-97 23:34:26 +RecordTest.c
  203.      138     119 13.7% 03-Nov-96 19:22:44 +SCOPTIONS
  204.      308     169 45.1% 02-Jul-97 10:29:54 +smakefile
  205.     2340    1640 29.9% 04-Nov-97 22:52:04 +CheckAHIPrefs
  206.     1965     796 59.4% 02-Nov-97 23:41:58 +CheckAHIPrefs.c
  207.      362     182 49.7% 02-Nov-97 23:46:18 +smakefile
  208.      389     159 59.1% 02-Nov-97 23:44:36 +Makefile
  209.     2382    1044 56.1% 01-May-96 20:13:30 +GetAudioID.info
  210.      840     474 43.5% 01-May-96 20:13:30 +empty.ct
  211.      376     232 38.2% 01-May-96 20:13:30 +GetAudioID.catalog
  212.     2276    1394 38.7% 01-May-96 20:13:30 +GetAudioID
  213.     8438    3543 58.0% 01-May-96 20:13:30 +GetAudioID.guide
  214.     1831    1130 38.2% 01-May-96 20:13:30 +GetAudioID.guide.info
  215.     1903     600 68.4% 01-May-96 20:13:30 +GetAudioID.info
  216.      841     463 44.9% 01-May-96 20:13:30 +GAI.cd
  217.    11973    4497 62.4% 01-May-96 20:13:30 +GAI.S
  218.     2960    1893 36.0% 04-Nov-97 22:50:00 +BestAudioID
  219.     2655     977 63.2% 02-Jul-97 10:24:02 +BestAudioID.c
  220.      150     116 22.6% 28-Jun-97 18:30:02 +SCOPTIONS
  221.      309     172 44.3% 02-Jul-97 10:30:44 +smakefile
  222.     3540    2200 37.8% 04-Nov-97 22:50:12 +DoubleBuffer
  223.     7604    2069 72.7% 03-Aug-97 18:36:36 +DoubleBuffer.c
  224.      153     121 20.9% 30-Sep-96 09:38:30 +SCOPTIONS
  225.      310     172 44.5% 02-Jul-97 10:30:04 +smakefile
  226.      830     511 38.4% 03-Jul-97 11:09:14 +HardDiskRecord.catalog
  227.     3397     951 72.0% 03-Jul-97 11:09:14 +HardDiskRecord.ct
  228.    13035    3406 73.8% 16-Sep-96 15:51:34 +GUI.c
  229.    16250    2348 85.5% 18-Jul-96 09:17:18 +GUI.des
  230.      292      91 68.8% 18-Jul-96 09:17:18 +GUI.extras.h
  231.     2546     737 71.0% 16-Sep-96 15:51:36 +GUI.h
  232.    12676    6911 45.4% 04-Nov-97 22:50:40 +HardDiskRecord
  233.    19955    5951 70.1% 23-Jan-97 18:59:54 +HardDiskRecord.c
  234.     2612     616 76.4% 16-Sep-96 15:51:34 +HardDiskRecord.cd
  235.     2896     659 77.2% 16-Sep-96 15:51:34 +HardDiskRecord.ct
  236.     1657     679 59.0% 18-Jul-96 09:17:18 +HardDiskRecord.h
  237.      374     246 34.2% 22-Apr-97 00:04:08 +HardDiskRecord.readme
  238.     3307    1191 63.9% 18-Jul-96 09:17:18 +recordfunc.a
  239.     1081     487 54.9% 03-Jul-97 12:01:12 +smakefile
  240.      620     391 36.9% 04-Nov-97 22:50:52 +ahi.lib
  241.     1226     580 52.6% 02-Apr-97 21:48:46 +AHI_lib.c
  242.      219     124 43.3% 03-Jul-97 12:07:12 +smakefile
  243.      473     218 53.9% 05-Jul-97 16:55:26 +Makefile
  244.     2318     761 67.1% 17-Apr-97 01:56:22 +PT-AHIPlay.h
  245.     1901     708 62.7% 17-Apr-97 01:56:26 +PT-AHIPlay.i
  246.     4508    2571 42.9% 04-Nov-97 22:50:58 +PT-AHIPlay.o
  247.    29995    7592 74.6% 11-Jul-97 11:17:14 +PT-AHIPlay.s
  248.    29117    7798 73.2% 17-Apr-97 01:26:54 +PT-AHIPlay_old.s
  249.      113      98 13.2% 02-Jul-97 10:35:46 +smakefile
  250.     7070    2045 71.0% 29-Apr-97 00:07:16 +Class.c
  251.     3038    1044 65.6% 18-Apr-97 17:38:54 +Data.h
  252.      485     268 44.7% 28-Oct-96 21:54:00 +DT_code.a
  253.      299     158 47.1% 29-Apr-97 13:03:44 +DT_ident
  254.     7179    2160 69.9% 18-Apr-97 17:39:16 +LibCode.c
  255.      263     152 42.2% 29-Apr-97 00:04:48 +protracker.datatype_rev.h
  256.      312     177 43.2% 29-Apr-97 00:04:48 +protracker.datatype_rev.i
  257.       15      15  0.0% 29-Apr-97 00:04:48 +protracker.datatype_rev.rev
  258.      281     168 40.2% 07-Oct-96 19:17:14 +protracker_rev.i
  259.       14      14  0.0% 07-Oct-96 19:17:14 +protracker_rev.rev
  260.      628     278 55.7% 29-Apr-97 13:08:12 +ProtrackerDT.info
  261.     7008    4034 42.4% 04-Nov-97 22:51:18 +protracker.datatype
  262.      248     196 20.9% 04-Nov-97 22:51:24 +Protracker
  263.      473     294 37.8% 13-Oct-96 09:16:24 +Protracker.info
  264.        3       3  0.0% 02-Jul-97 11:05:08 +Protracker
  265.      643     287 55.3% 29-Apr-97 13:04:08 +Install
  266.      726     361 50.2% 29-Apr-97 13:07:38 +Install.info
  267.     1189     650 45.3% 29-Apr-97 13:09:38 +ProtrackerDT.readme
  268.      468     231 50.6% 29-Apr-97 13:07:38 +ProtrackerDT.readme.info
  269.     1338     529 60.4% 18-Apr-97 12:31:26 +RomTag.a
  270.     1246     628 49.5% 03-Jul-97 11:47:36 +SMakefile
  271.     2635    1234 53.1% 17-Nov-96 16:05:12 +RecordTestQnD.s
  272.     2280    1544 32.2% 04-Nov-97 22:51:38 +Req-test
  273.     1915     855 55.3% 28-Jun-97 18:27:28 +req-test.c
  274.      150     116 22.6% 02-Apr-97 21:59:08 +SCOPTIONS
  275.      306     168 45.0% 02-Jul-97 10:29:32 +smakefile
  276.      153     121 20.9% 26-Jan-97 22:52:12 +SCOPTIONS
  277.     3760    2438 35.1% 04-Nov-97 22:51:52 +SimplePlay
  278.    10853    2926 73.0% 23-Apr-97 20:09:34 +SimplePlay.c
  279.      308     172 44.1% 02-Jul-97 10:31:12 +smakefile
  280.      371     149 59.8% 02-Nov-97 23:44:18 +Makefile
  281.     4914     993 79.7% 04-Nov-97 22:59:38 +ahi.h
  282.     3115     696 77.6% 04-Nov-97 22:59:38 +ahi_sub.h
  283.       53      53  0.0% 15-Nov-96 00:23:00 +ahi_pragmas.h
  284.       61      61  0.0% 15-Nov-96 00:23:12 +ahi_sub_pragmas.h
  285.      188     135 28.1% 11-Jan-97 20:26:18 +ahi.h
  286.      205     144 29.7% 11-Jan-97 20:26:28 +ahi_sub.h
  287.    14170    4552 67.8% 27-Apr-97 14:08:44 +ahi.i
  288.     2661    1103 58.5% 02-Apr-97 22:03:52 +ahi_sub.i
  289.      850     287 66.2% 04-Nov-97 22:59:32 +ahi_lib.i
  290.      628     226 64.0% 04-Nov-97 22:59:32 +ahi_sub_lib.i
  291.     2011     632 68.5% 02-Apr-97 22:06:16 +ahi_protos.h
  292.     1424     503 64.6% 02-Apr-97 22:06:06 +ahi_sub_protos.h
  293.    14198    4172 70.6% 27-Apr-97 14:08:34 +ahi.h
  294.     3495    1249 64.2% 18-May-97 16:10:54 +ahi_sub.h
  295.      396     213 46.2% 04-Nov-97 22:59:40 +ahi.m
  296.      300     159 47.0% 04-Nov-97 22:59:40 +ahi_sub.m
  297.     4702    1933 58.8% 04-Nov-97 22:59:44 +ahi.m
  298.      822     425 48.2% 04-Nov-97 22:59:48 +ahi_sub.m
  299.      991     432 56.4% 02-Apr-97 22:06:42 +ahi_lib.fd
  300.      796     313 60.6% 26-Mar-97 23:25:16 +ahi_sub_lib.fd
  301.     1820     535 70.6% 04-Nov-97 22:59:34 +ahi_pragmas.h
  302.     1073     331 69.1% 04-Nov-97 22:59:36 +ahi_sub_pragmas.h
  303.      191     129 32.4% 04-Nov-97 22:59:36 +ahi.h
  304.      214     138 35.5% 04-Nov-97 22:59:36 +ahi_sub.h
  305.     1809     521 71.1% 04-Nov-97 22:59:32 +ahi_lib.h
  306.     1107     344 68.9% 04-Nov-97 22:59:34 +ahi_sub_lib.h
  307.      186     127 31.7% 04-Nov-97 22:59:34 +ahi.h
  308.      209     139 33.4% 04-Nov-97 22:59:34 +ahi_sub.h
  309.       50      48  4.0% 03-Mar-96 17:41:04 +ReadMe.txt
  310.     4696    2857 39.1% 08-Jul-97 00:25:36 +ScanAudioModes
  311.     8456    4950 41.4% 31-Dec-95 17:15:38 +sift
  312.     5765    1912 66.8% 21-May-96 19:19:16 +ScanAudioModes.c
  313.       85      69 18.8% 08-Jul-97 00:25:26 +SCOPTIONS
  314.      265     172 35.0% 21-May-96 19:19:30 +smakefile
  315.     5612    2503 55.3% 31-Dec-95 17:15:38 +sift.c
  316.    20821    7436 64.2% 03-Nov-97 00:13:28 +History
  317.      468     231 50.6% 08-Aug-97 17:39:30 +History.info
  318.    76850   20590 73.2% 02-Nov-97 00:01:38 +Install AHI
  319.      709     354 50.0% 08-Aug-97 17:39:30 +Install AHI.info
  320. -------- ------- ----- --------- --------
  321.  1108967  335500 69.7% 11-Nov-97 22:23:28   166 files
  322.